Node / meshtastic / Meshtastic-Android / files / feature / node / src / commonMain / kotlin / org / meshtastic / feature / node / component / NodeHopHistogram.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.node.component

Tff7b72import T7ee787androidx.compose.foundation.layout.Arrangement

Tff7b72import T7ee787androidx.compose.foundation.layout.Column

Tff7b72import T7ee787androidx.compose.foundation.layout.ExperimentalLayoutApi

Tff7b72import T7ee787androidx.compose.foundation.layout.FlowRow

Tff7b72import T7ee787androidx.compose.foundation.layout.Row

Tff7b72import T7ee787androidx.compose.foundation.layout.fillMaxWidth

Tff7b72import T7ee787androidx.compose.foundation.layout.padding

Tff7b72import T7ee787androidx.compose.foundation.layout.widthIn

Tff7b72import T7ee787androidx.compose.foundation.rememberScrollState

Tff7b72import T7ee787androidx.compose.foundation.verticalScroll

Tff7b72import T7ee787androidx.compose.material3.ExperimentalMaterial3Api

Tff7b72import T7ee787androidx.compose.material3.FilterChip

Tff7b72import T7ee787androidx.compose.material3.LinearProgressIndicator

Tff7b72import T7ee787androidx.compose.material3.MaterialTheme

Tff7b72import T7ee787androidx.compose.material3.ModalBottomSheet

Tff7b72import T7ee787androidx.compose.material3.ProgressIndicatorDefaults

Tff7b72import T7ee787androidx.compose.material3.Text

Tff7b72import T7ee787androidx.compose.material3.rememberModalBottomSheetState

Tff7b72import T7ee787androidx.compose.runtime.Composable

Tff7b72import T7ee787androidx.compose.runtime.getValue

Tff7b72import T7ee787androidx.compose.runtime.mutableStateOf

Tff7b72import T7ee787androidx.compose.runtime.remember

Tff7b72import T7ee787androidx.compose.runtime.setValue

Tff7b72import T7ee787androidx.compose.ui.Alignment

Tff7b72import T7ee787androidx.compose.ui.Modifier

Tff7b72import T7ee787androidx.compose.ui.semantics.clearAndSetSemantics

Tff7b72import T7ee787androidx.compose.ui.semantics.contentDescription

Tff7b72import T7ee787androidx.compose.ui.semantics.heading

Tff7b72import T7ee787androidx.compose.ui.semantics.semantics

Tff7b72import T7ee787androidx.compose.ui.text.style.TextAlign

Tff7b72import T7ee787androidx.compose.ui.unit.dp

Tff7b72import T7ee787org.jetbrains.compose.resources.StringResource

Tff7b72import T7ee787org.jetbrains.compose.resources.stringResource

Tff7b72import T7ee787org.meshtastic.core.common.util.nowInstant

Tff7b72import T7ee787org.meshtastic.core.model.Node

Tff7b72import T7ee787org.meshtastic.core.resources.Res

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_nodes_at_hop

Tff7b72import T7ee787org.meshtastic.core.resources.all_time

Tff7b72import T7ee787org.meshtastic.core.resources.eight_hours

Tff7b72import T7ee787org.meshtastic.core.resources.hop_histogram_empty

Tff7b72import T7ee787org.meshtastic.core.resources.hop_histogram_title

Tff7b72import T7ee787org.meshtastic.core.resources.one_hour

Tff7b72import T7ee787org.meshtastic.core.resources.twenty_four_hours

Tff7b72import T7ee787kotlin.time.Duration.Companion.hours

T8b949e/**

* Counts nodes at each hop distance, as a list indexed by hop (element 0 = direct nodes). The list is contiguous from

* hop 0 up to the furthest hop observed, so zero-count gaps in the middle are preserved. Nodes with an unknown hop

* (`hopsAway < 0`) are excluded. When [cutoffSecs] is non-null, only nodes with `lastHeard >= cutoffSecs` are counted.

* Returns an empty list when nothing qualifies.

*/

Tff7b72fun Td2a8ffhopHistogramTb4b4b4(Te6edf3nodesTb4b4b4: Te6edf3ListTff7b72<Te6edf3NodeTff7b72>Tb4b4b4, Te6edf3cutoffSecsTb4b4b4: Tffa657Int?Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Tffa657IntTff7b72> Tb4b4b4{

Tff7b72val Te6edf3counts Tff7b72=

Te6edf3nodes

Tb4b4b4.Te6edf3filter Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3hopsAway Tff7b72>Tff7b72= T79c0ff0 Tff7b72&Tff7b72& Tb4b4b4(Te6edf3cutoffSecs Tff7b72=Tff7b72= Tff7b72null Tff7b72|Tff7b72| Tffa657itTb4b4b4.Te6edf3lastHeard Tff7b72>Tff7b72= Te6edf3cutoffSecsTb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3groupingBy Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3hopsAway Tb4b4b4}

Tb4b4b4.Te6edf3eachCountTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3maxHop Tff7b72= Te6edf3countsTb4b4b4.Te6edf3keysTb4b4b4.Te6edf3maxOrNullTb4b4b4(Tb4b4b4) Tff7b72?: Tff7b72return Te6edf3emptyListTb4b4b4(Tb4b4b4)

Tff7b72return Tb4b4b4(T79c0ff0.Tb4b4b4.Te6edf3maxHopTb4b4b4)Tb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3countsTff7b72[Tffa657itTff7b72] Tff7b72?: T79c0ff0 Tb4b4b4}

Tb4b4b4}

T8b949e/**

* Bottom sheet showing how many mesh nodes sit at each hop distance, filtered to a "last heard" [HopWindow]. Gives a

* quick sense of how busy and dispersed the local mesh is (see issue #5745).

*/

Tf0883e@OptInTb4b4b4(Te6edf3ExperimentalMaterial3ApiTff7b72::Te6edf3classTb4b4b4)

Tf0883e@Composable

Tff7b72fun Td2a8ffNodeHopHistogramSheetTb4b4b4(Te6edf3nodesTb4b4b4: Te6edf3ListTff7b72<Te6edf3NodeTff7b72>Tb4b4b4, Te6edf3onDismissTb4b4b4: Tb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3sheetState Tff7b72= Te6edf3rememberModalBottomSheetStateTb4b4b4(Te6edf3skipPartiallyExpanded Tff7b72= Tff7b72trueTb4b4b4)

Tff7b72var Te6edf3window Tff7b72by Te6edf3remember Tb4b4b4{ Te6edf3mutableStateOfTb4b4b4(Te6edf3HopWindowTb4b4b4.Te6edf3EIGHT_HOURSTb4b4b4) Tb4b4b4}

Te6edf3ModalBottomSheetTb4b4b4(Te6edf3onDismissRequest Tff7b72= Te6edf3onDismissTb4b4b4, Te6edf3sheetState Tff7b72= Te6edf3sheetStateTb4b4b4) Tb4b4b4{

Te6edf3HopHistogramContentTb4b4b4(Te6edf3nodes Tff7b72= Te6edf3nodesTb4b4b4, Te6edf3window Tff7b72= Te6edf3windowTb4b4b4, Te6edf3onSelectWindow Tff7b72= Tb4b4b4{ Te6edf3window Tff7b72= Tffa657it Tb4b4b4}Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

T8b949e/** Stateless sheet content — split out from [NodeHopHistogramSheet] so it can be previewed without a sheet host. */

Tf0883e@OptInTb4b4b4(Te6edf3ExperimentalLayoutApiTff7b72::Te6edf3classTb4b4b4)

Tf0883e@Composable

Tff7b72internal Tff7b72fun Td2a8ffHopHistogramContentTb4b4b4(Te6edf3nodesTb4b4b4: Te6edf3ListTff7b72<Te6edf3NodeTff7b72>Tb4b4b4, Te6edf3windowTb4b4b4: Te6edf3HopWindowTb4b4b4, Te6edf3onSelectWindowTb4b4b4: Tb4b4b4(Te6edf3HopWindowTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3cutoffSecs Tff7b72=

Te6edf3rememberTb4b4b4(Te6edf3windowTb4b4b4) Tb4b4b4{ Te6edf3windowTb4b4b4.Te6edf3hoursTff7b72?.Te6edf3let Tb4b4b4{ Tb4b4b4(Te6edf3nowInstantTb4b4b4.Te6edf3epochSeconds Tff7b72- Tffa657itTb4b4b4.Te6edf3hoursTb4b4b4.Te6edf3inWholeSecondsTb4b4b4)Tb4b4b4.Te6edf3toIntTb4b4b4(Tb4b4b4) Tb4b4b4} Tb4b4b4}

Tff7b72val Te6edf3buckets Tff7b72= Te6edf3rememberTb4b4b4(Te6edf3nodesTb4b4b4, Te6edf3cutoffSecsTb4b4b4) Tb4b4b4{ Te6edf3hopHistogramTb4b4b4(Te6edf3nodesTb4b4b4, Te6edf3cutoffSecsTb4b4b4) Tb4b4b4}

Tff7b72val Te6edf3maxCount Tff7b72= Te6edf3bucketsTb4b4b4.Te6edf3maxOrNullTb4b4b4(Tb4b4b4) Tff7b72?: T79c0ff0

Te6edf3ColumnTb4b4b4(

Te6edf3modifier Tff7b72=

Te6edf3ModifierTb4b4b4.Te6edf3fillMaxWidthTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3verticalScrollTb4b4b4(Te6edf3rememberScrollStateTb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4.Te6edf3paddingTb4b4b4(Te6edf3horizontal Tff7b72= T79c0ff2T79c0ff4.Te6edf3dpTb4b4b4, Te6edf3vertical Tff7b72= T79c0ff1T79c0ff6.Te6edf3dpTb4b4b4)Tb4b4b4,

Te6edf3verticalArrangement Tff7b72= Te6edf3ArrangementTb4b4b4.Te6edf3spacedByTb4b4b4(T79c0ff1T79c0ff6.Te6edf3dpTb4b4b4)Tb4b4b4,

Tb4b4b4) Tb4b4b4{

Te6edf3TextTb4b4b4(

Te6edf3text Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3hop_histogram_titleTb4b4b4)Tb4b4b4,

Te6edf3style Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3typographyTb4b4b4.Te6edf3headlineSmallTb4b4b4,

Te6edf3modifier Tff7b72= Te6edf3ModifierTb4b4b4.Te6edf3semantics Tb4b4b4{ Te6edf3headingTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4,

Tb4b4b4)

Te6edf3FlowRowTb4b4b4(Te6edf3horizontalArrangement Tff7b72= Te6edf3ArrangementTb4b4b4.Te6edf3spacedByTb4b4b4(T79c0ff8.Te6edf3dpTb4b4b4)Tb4b4b4) Tb4b4b4{

Te6edf3HopWindowTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3option Tff7b72-Tff7b72>

Te6edf3FilterChipTb4b4b4(

Te6edf3selected Tff7b72= Te6edf3option Tff7b72=Tff7b72= Te6edf3windowTb4b4b4,

Te6edf3onClick Tff7b72= Tb4b4b4{ Te6edf3onSelectWindowTb4b4b4(Te6edf3optionTb4b4b4) Tb4b4b4}Tb4b4b4,

Te6edf3label Tff7b72= Tb4b4b4{ Te6edf3TextTb4b4b4(Te6edf3stringResourceTb4b4b4(Te6edf3optionTb4b4b4.Te6edf3labelTb4b4b4)Tb4b4b4) Tb4b4b4}Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tff7b72if Tb4b4b4(Te6edf3bucketsTb4b4b4.Te6edf3isEmptyTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4{

Te6edf3TextTb4b4b4(

Te6edf3text Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3hop_histogram_emptyTb4b4b4)Tb4b4b4,

Te6edf3style Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3typographyTb4b4b4.Te6edf3bodyMediumTb4b4b4,

Te6edf3color Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3colorSchemeTb4b4b4.Te6edf3onSurfaceVariantTb4b4b4,

Tb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3bucketsTb4b4b4.Te6edf3forEachIndexed Tb4b4b4{ Te6edf3hopTb4b4b4, Te6edf3count Tff7b72-Tff7b72> Te6edf3HopBarTb4b4b4(Te6edf3hop Tff7b72= Te6edf3hopTb4b4b4, Te6edf3count Tff7b72= Te6edf3countTb4b4b4, Te6edf3maxCount Tff7b72= Te6edf3maxCountTb4b4b4) Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tf0883e@Composable

Tff7b72private Tff7b72fun Td2a8ffHopBarTb4b4b4(Te6edf3hopTb4b4b4: Tffa657IntTb4b4b4, Te6edf3countTb4b4b4: Tffa657IntTb4b4b4, Te6edf3maxCountTb4b4b4: Tffa657IntTb4b4b4) Tb4b4b4{

T8b949e// Merge the row into one spoken node so a screen reader announces "Hop 3: 2 nodes" rather than

T8b949e// reading the hop number, progress-bar percentage, and count as three disjoint elements.

Tff7b72val Te6edf3description Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_nodes_at_hopTb4b4b4, Te6edf3hopTb4b4b4, Te6edf3countTb4b4b4)

Te6edf3RowTb4b4b4(

Te6edf3modifier Tff7b72= Te6edf3ModifierTb4b4b4.Te6edf3fillMaxWidthTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3clearAndSetSemantics Tb4b4b4{ Te6edf3contentDescription Tff7b72= Te6edf3description Tb4b4b4}Tb4b4b4,

Te6edf3horizontalArrangement Tff7b72= Te6edf3ArrangementTb4b4b4.Te6edf3spacedByTb4b4b4(T79c0ff1T79c0ff2.Te6edf3dpTb4b4b4)Tb4b4b4,

Te6edf3verticalAlignment Tff7b72= Te6edf3AlignmentTb4b4b4.Te6edf3CenterVerticallyTb4b4b4,

Tb4b4b4) Tb4b4b4{

Te6edf3TextTb4b4b4(

Te6edf3text Tff7b72= Te6edf3hopTb4b4b4.Te6edf3toStringTb4b4b4(Tb4b4b4)Tb4b4b4,

Te6edf3style Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3typographyTb4b4b4.Te6edf3titleMediumTb4b4b4,

Te6edf3textAlign Tff7b72= Te6edf3TextAlignTb4b4b4.Te6edf3CenterTb4b4b4,

Te6edf3modifier Tff7b72= Te6edf3ModifierTb4b4b4.Te6edf3widthInTb4b4b4(Te6edf3min Tff7b72= T79c0ff2T79c0ff0.Te6edf3dpTb4b4b4)Tb4b4b4,

Tb4b4b4)

Te6edf3LinearProgressIndicatorTb4b4b4(

Te6edf3progress Tff7b72= Tb4b4b4{ Tff7b72if Tb4b4b4(Te6edf3maxCount Tff7b72> T79c0ff0Tb4b4b4) Te6edf3countTb4b4b4.Te6edf3toFloatTb4b4b4(Tb4b4b4) Tff7b72/ Te6edf3maxCount Tff7b72else T79c0ff0f Tb4b4b4}Tb4b4b4,

Te6edf3modifier Tff7b72= Te6edf3ModifierTb4b4b4.Te6edf3weightTb4b4b4(T79c0ff1fTb4b4b4)Tb4b4b4,

Te6edf3trackColor Tff7b72= Te6edf3ProgressIndicatorDefaultsTb4b4b4.Te6edf3linearTrackColorTb4b4b4,

Te6edf3strokeCap Tff7b72= Te6edf3ProgressIndicatorDefaultsTb4b4b4.Te6edf3LinearStrokeCapTb4b4b4,

Tb4b4b4)

Te6edf3TextTb4b4b4(

Te6edf3text Tff7b72= Te6edf3countTb4b4b4.Te6edf3toStringTb4b4b4(Tb4b4b4)Tb4b4b4,

Te6edf3style Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3typographyTb4b4b4.Te6edf3titleMediumTb4b4b4,

Te6edf3textAlign Tff7b72= Te6edf3TextAlignTb4b4b4.Te6edf3EndTb4b4b4,

Te6edf3modifier Tff7b72= Te6edf3ModifierTb4b4b4.Te6edf3widthInTb4b4b4(Te6edf3min Tff7b72= T79c0ff2T79c0ff8.Te6edf3dpTb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

T8b949e/** "Last heard" windows offered above the histogram. A `null` [hours] means no time filter (all known nodes). */

Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffMagicNumberTa5d6ff"Tb4b4b4)

Tff7b72enum Tff7b72class T56d364HopWindowTb4b4b4(Tff7b72val Te6edf3hoursTb4b4b4: Tffa657Long?Tb4b4b4, Tff7b72val Te6edf3labelTb4b4b4: Te6edf3StringResourceTb4b4b4) Tb4b4b4{

Te6edf3ALLTb4b4b4(Tff7b72nullTb4b4b4, Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3all_timeTb4b4b4)Tb4b4b4,

Te6edf3ONE_HOURTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3one_hourTb4b4b4)Tb4b4b4,

Te6edf3EIGHT_HOURSTb4b4b4(T79c0ff8Tb4b4b4, Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3eight_hoursTb4b4b4)Tb4b4b4,

Te6edf3ONE_DAYTb4b4b4(T79c0ff2T79c0ff4Tb4b4b4, Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3twenty_four_hoursTb4b4b4)Tb4b4b4,

Tb4b4b4}